home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / mus / edit / pt2_3a.lha / PT.ReadMe! < prev    next >
Text File  |  1990-12-10  |  17KB  |  355 lines
  1. -------------------------------------------------------------------------
  2. Protracker V2.3 Release A - (C) 1993 Mushroom Studios/Noxious   1/1-1993
  3. -------------------------------------------------------------------------
  4.  
  5. Protracker is a Public Domain program, and may may be copied freely and
  6. included in any PD library. You may not charge anything for the program
  7. other than the cost of the disk and the PD-service.
  8.  
  9. This disk should contain the following files:
  10.  
  11.   PT2.3A                 -  The main program.
  12.   PT2.3A.info            -  The Icon for Protracker. (drawn by Markus Jentsch)
  13.   PROP                   -  Protracker module player.
  14.   PT.TempoCalc.txt       -  How to calculate tempo etc.
  15.   PT-Play.s              -  Playroutine for the Seka or DevPac assemblers.
  16.   PT-CIAPlay.s           -  Playroutine for CIA timing.
  17.   PT.FileFormat.txt      -  Description of the file format.
  18.   PT.Effects.txt         -  Quick help on all effect commands.
  19.   PT.help                -  Online helpfile for PT2.3A (press the Help key).
  20.   PT.help.txt            -  Read-/Printable version of the help file.
  21.   PT.help.txt.info       -  Icon for the PT.help.txt file.
  22.   PT.config-00           -  Default configuration file.
  23.   PT.Update!             -  Textfile with changes from PT2.2A
  24.   PT.Update!.info        -  Icon for the PT.Update! file.
  25.   PT.ReadMe!             -  ****--> This file <--**** 
  26.   PT.ReadMe!.info        -  Icon for the PT.ReadMe! file.
  27.  
  28. Some info..
  29. -----------
  30.  
  31. This disk contains all the necessary files to run Shell, CLI, and all the
  32. most used CLI-Commands. It is possible to print songs, but we'we only
  33. included the Generic printerdriver, so you'll have to install your own.
  34. Remember to set the new printerdriver with Preferences. If you make your
  35. own workdisk, remember to copy the commands "Run" and "EndCLI".
  36.  
  37. If you are going to make make a compact-disk containing Protracker, please 
  38. include PT.help and powerpacker.library!!! THIS IS VERY IMPORTANT!!!
  39.  
  40.              DO NOT ATTEMPT TO EDIT THE HELP-FILE!!!
  41.  
  42. The first 1024 bytes are a text-offset index for Protracker, so keep off. 
  43.  
  44. For more info, press the HELP key when you have started Protracker.
  45.  
  46. It isn't possible to load old configuration files with PT2.3A, but if you
  47. load an old config-file into an editor and change the first 5 letters to
  48. "PT2.3", you might be able to use it, but some new functions may be set to
  49. zero though. Remember to check the DMA-wait and all the other functions
  50. or you'll experience some crashes etc...
  51.  
  52.  
  53.  
  54. --- Protracker history ---
  55.  
  56. First Version 1.0 (A) - Full of bugs...
  57.  
  58. Bugs corrected in V1.0 Release B:
  59. ---------------------------------
  60.  - PatternLoop (It always jumped to the start of the pattern, not the loop)
  61.  - Zap had put FineTune AND Glissando-Control in the same command! (E3)
  62.  - Fade Up / Down caused shit and even a few gurus!
  63.  - Delete Pos inserted pattern 77 (!) at position 127 in the song, causing
  64.    it to be longer than 80k!
  65.  - Filter All Samples was slow as hell because it tried to filter non-
  66.    existant samples.
  67.  - If you selected sample 0 from the keypad, it always played the last
  68.    sample played as sample 0!
  69.  - A590 harddisk owners couldn't use the keyboard because of the way Mahoney
  70.    & Kaktus set up the keyboard interrupt (we used their NT1.1 routine).
  71.  - Entering the help screen when in the midi screen fucked up the display.
  72.  - Escaping from Mix exited from the whole edit op.!
  73.  - CutBeg no longer fucks up the Sample length and Pos.
  74.  - The help file was FULL of bugs / misspellings.
  75.  
  76. Bugs corrected in V1.0 Release C:
  77. ---------------------------------
  78.  - Error in Finetune-table2 (note B-2)
  79.  - Abort Load sometimes caused a guru!
  80.  - Toneportamento (cmd 3) didn't work correctly with finetune.
  81.  - PLST screen was one pixel off.
  82.  
  83.  MIDI screen was removed.
  84.  
  85.  
  86. Changes and improvements from Protracker V1.0C to V1.1A:
  87. --------------------------------------------------------
  88.  
  89. General:
  90.   - Protracker will now run if you have Kickstart 2.0 installed!
  91.     (A500, A1000, A2000, A3000 etc...)
  92.   - Protracker will also "Auto runback" when you start from CLI!
  93.     There's no need to use the 'run' command.
  94.   - Keyboard and mouse input is provided by an InputHandler with prior-
  95.     ity 52. The handler will grab all RAWKEY and RAWMOUSE events from
  96.     the input.device before they reach intuition. PT will no longer
  97.     interfere with windows and gadgets on the intuition screen behind.
  98.   - Keyboard buffer. Wow!!! Now you can play really fast, and PT won't
  99.     miss a single key (...well, not as many as it used to before...).
  100.   - The vertical blank interrupt no longer patches the vector itself, but
  101.     uses the AddIntServer function.
  102.   - The playroutine creates it's own CIA or VBLANK interrupt, and it will
  103.     not be removed if a song is playing when you go to CLI/Workbench.
  104.   - Text input routine changed a little. Use mouse to set pos and to exit.
  105.   - Improved "Out of memory" handling (hopefully no more gurus...).
  106.   - Only the first 2 bytes of a sample will be zeroed (were the first 4).
  107.   - Lots of new keyboard commands/shortcuts using the Alt key.
  108.   - Vibrato depth changed to be compatible with NT2.0. Double all your
  109.     depth numbers if you load old protracker songs.
  110.   - Funk Repeat changed to Invert Loop (may trash your samples though).
  111.   - Play samples from the keypad (dot mode) when pressing backslash.
  112.  
  113. Main Screen:
  114.   - MIDI screen has been removed. Changed to sampler instead. MIDI input
  115.     is still there, but there's no MIDI output. Sorry...
  116.   - Quadrascope. Four channel oscilloscope that displays the samples
  117.     in real-time, even when playing from keyboard. The good old spectrum
  118.     analyzer is still there, just click on the scope to toggle.
  119.   - Tempo gadget. Default is 125 BPM (normal vblank speed), but that can be
  120.     changed if you select CIA timing on Setup2. Range is 32-255 BPM, and
  121.     can also be changed with the 'F' effect command (speed/tempo).
  122.   - Repeat and replen will be updated in the samples when you change them.
  123.     You no longer have to press a key to hear the new loop.
  124.   - Protracker should now be able to show up to 10/16 megs of freemem.
  125.   - Error messages when PLST or Config not found.
  126.   - Click to enter position, pattern and length with the keyboard.
  127.  
  128. Disk Op.:
  129.   - Choose RAW or IFF when saving samples.
  130.   - Samples can be saved with IFF-loops.
  131.   - Change path without reading directory.
  132.   - All 30 characters in filename/directory stored (was 24).
  133.   - Shows directories, just click to add directory to path.
  134.   - Parent directory gadget.
  135.   - One preset and several default paths for modules/songs/samples.
  136.   - PT will now read an "unlimited" number of directory entries (was 200).
  137.  
  138. Setup:
  139.   - The only thing that's happened here is a small gadget labeled "2".
  140.     Pressing it will put you in...
  141.  
  142. Setup2:
  143.   - 8 new on/off toggles.
  144.     Override: Load/save sample from samplepath even if there's a path
  145.       in the samplename. ST-37:bigbadbass with override will be loaded
  146.       from DF0: (or whatever) instead of ST-37:. You may want to put
  147.       all your samples in one big directory on your harddisk...
  148.     NoSamples: Will load a song without asking for the samples.
  149.     BlankZero: This will show the samplenumbers in the pattern in the
  150.       same way as Noisetracker 1.2 (Zeros are blanked out).
  151.     Show Dirs: If on, directories will be shown in Disk Op.
  152.     Show Publ: If on, PT will show all free Public memory, otherwise
  153.       just free Chip memory.
  154.     CutToBuff: If on, the part of the sample cut away in the sample
  155.       editor will be saved in the copybuffer.
  156.     Load Loop: Will load loops from an IFF file when loading a sample,
  157.       or adding a path in the sampleeditor.
  158.     Slow Mode: Use this toggle if you have a 25 Mhz A3000 where every-
  159.       thing is faster. Turning it on might help.
  160.   - Set Default paths.
  161.   - You can set the maximum number of presets (used to be 2500).
  162.   - DMA wait. Use this on 25MHz Amigas (normally 300, use 900 on A3000).
  163.   - Set tuning tone (note and volume).
  164.   - Select CIA or VBlank timing.
  165.   - Set default CIA tempo.
  166.   - Spectrum Analyzer/VU-meter copper color editor!
  167.  
  168. Preset Editor:
  169.   - Use Preset removed, inserted Delete Disk instead.
  170.   - You can now save Finetune instead of Volume in the PLST. 
  171.   - ST-disk number changed to hex (ST-00 --> ST-FF)!
  172.   - Adding samples with IFF-loops to the presetlist is possible.
  173.   - Proper PLST allocation. Protracker will no longer allocate
  174.     any memory if there's no PLST.
  175.  
  176. PLST:
  177.   - ST-disk number changed to HEX. This means you can have
  178.     up to $FF, or 255 ST-disks (used to be 99).
  179.  
  180. Sampler/Sample Editor:
  181.   - Sample Graphing like Audiomaster. With Show Range, Show All,
  182.     Zoom Out, Range All, etc...
  183.   - Play either Waveform, Display or Range.
  184.   - Repeat points are shown, and can be dragged around.
  185.   - Loop on/off toggle.
  186.   - A line shows current position when playing back a sample.
  187.   - A sampler just like on NT2.0.
  188.   - Resample function w/tuning tone.
  189.   - Cut, Copy and Paste functions.
  190.   - Cursor to beginning/end.
  191.   - Swap current sample with copybuffer.
  192.  
  193. Edit Op.:
  194.   1 - Transpose All bug removed.
  195.   2 - Move changed to Copy (use this to copy samples too).
  196.   3 - Upsample changed a tiny bit (allocation).
  197.   3 - Most functions will now work with marked ranges.
  198.  
  199. Bugfixes and changes from PT1.1A to PT1.1B:
  200. -------------------------------------------
  201.  
  202. - Load gadget no longer hangs the program when trying to load a file that
  203.   doesn't exist.
  204. - Better filehandling with error messages.
  205. - Repeat and replen check installed (Rel. A hanged when replen accidentally
  206.   got the value zero).
  207. - Repeat and replen were swapped when loading an IFF sample.
  208. - Only RepLen values in IFF samples were added in the preset-editor.
  209. - Tune memory wasn't always updated when editing samples.
  210. - Swap Buffer debugged.
  211. - The arpeggio sounded weird because the pitch wasn't set back at the
  212.   right time.
  213. - Shift speeds up the scrolling in the PLST and preset-editor.
  214.  
  215. ---------------------------------------------------------
  216. Bugfixes and improvements from PT1.1B(& PT2.0) to PT2.1A:
  217. ---------------------------------------------------------
  218.  
  219. - mod. prefix was shown in the file-list if it wasn't lowercase only.
  220. - ReturnfromCLI requester enhanced with quitgadget.
  221. - Gadgetpositions fixed properly.
  222. - Accidental and Diskspace bugs fixed.
  223. - Editskip has now got an indicator.
  224. - DISK OP., PLST and PRESET-ED screens have TOP/BOTTOM gadgets.
  225. - PLST screen has now got Up/Down arrows.
  226. - PT can load&save powerpacked samples/modules.
  227. - PT can load&save tracks/patterns.
  228. - Format disk bug has been fixed (I hope).
  229. - Volume,Repeat,Replen,Pos & Mod is now editable from the keyboard.
  230.   Just click on the numbergadgets.
  231. - You can now choose an autoinserteffect of your own.(One of the ten
  232.   effectmacros).
  233. - The bug that completely turned the sound off when stopping the recording
  234.   has now been fixed.
  235. - You are now able to fastscroll the file- and presetlist to the next
  236.   startcharacter.Try it out yourselves...hard to explain.
  237. - The preset-ed routines have been corrected.To use your old PLST, simply
  238.   delete preset #0.
  239. - The metronome has now got an accent on the first beat.
  240. - A metronome keyboard toggle has been included.
  241. - The metronomechannel can easily be changed to the current cursorposition.
  242. - Most of the numbergadgets can now be zero'ed.
  243. - Better patternrefresh when doing keyboard I/O.
  244. - PT now reads the dir after rename/save/delete if the Autodirtoggle is on.
  245. - You can solo a channel with the mouse by holding the right mousebutton
  246.   while pressing 1,2,3 or 4.
  247. - You can pass an argument from workbench/shell/cli to automatically load
  248.   a module when PT starts.
  249. - Powerpacker crunching/decrunching with powerpacker.library!
  250.   PT will automaticly append/remove ".pp" to/from the filename.
  251. - You can save an Icon together with the module.
  252.  
  253. ------------------------------------------------
  254. Bugfixes and improvements from PT2.1A to PT2.2A:
  255. ------------------------------------------------
  256.  
  257. - I have fixed the chip-mem bug from PT2.1A.(it didn't work with chipmem only)
  258. - When Preset-ed screen was shown,you couldn't use the gadgets on the lower
  259.   part of the main- or sample-screen.
  260. - When autoexitdirtoggle was off,PT didn't change the songname when you loaded
  261.   a new song/module until you exit from disk op.
  262. - If you resampled a sample with big difference between the tunetone and the
  263.   resampletone then the new length was incorrectly computed.
  264. - If you ran out of memory when allocating crunchbuffersize then ... software
  265.   failure! This should work just fine now.
  266. - If you loaded a sample with a '.' in the samplename then PT set the length
  267.   incorrectly in some cases (see below)
  268. - Save module should work fine now.(another nasty bug is swept away!)
  269. - The Sampler works fine on ks2.0 (This version tests diskactivity before
  270.   sampling, PT1.3 doesn't!)
  271.   ***********************************************************************
  272.   * Thanks to Matrix/LSD for sending the working piece of source to me! *
  273.   ***********************************************************************
  274. - The timer is updated when you play a song while jumping out to Workbench.
  275. - The Loopsprites are working fine with screenadjust.
  276. - Stepplay works fine now. Amiga+Backspace is gone though.
  277. - MIDI in functions are working now, I hope!
  278. - Inputhandler debugged a little.
  279. - ShowFreeDiskGadget debugged (again). Before it showed 2 sectors too much.
  280. - If you pressed the deletefile gadget and then pressed a directoryname in
  281.   the list then the dir was added to the path but the directory wasn't opened.
  282.   This is now fixed.
  283. - PrintSong now prints the patternlist with decimal values. It prints all
  284.   patterns.(Older versions of PT missed to print the highest pattern)
  285. - I have implemented a chord maker.
  286. - I have implemented e Position-Editor.
  287. - On request, I have made ''multitasking'' like in PT1.3.
  288. - ProTracker has it's own screen. When the PT screen is in front of all other
  289.   screens, PT will wake up.
  290. - The browse function is modified to act like PT1.3. It shows the current
  291.   devices and disknames.
  292. - If you hold the right mousebutton while pressing the browsegadget a disklist
  293.   will pop up showing all the device- and disknames from the browsegadget in
  294.   the filenamewindow. Pressing a name will autoload that directory.
  295. - If you press LeftShift+any key 0-9 a-z while in DiskOp,  PLST or PresetEd,
  296.   PT will move you to the position in the list with a name beginning with the
  297.   corresponding character.
  298. - If you use MIDI I've added two new keys. A-2 and B-2 on the Synthkeyboard
  299.   are used as SampleNumber Up/Down! I have also Transposed the MIDInotes input
  300.   one octave down (because Dolphin has a small keyboard and couldn't access
  301.   the upper octave,C#3 - B-3).
  302. - I have added a SaveExecutable option.
  303. - 9 new toggles.
  304.  
  305. ------------------------------------------------
  306. Bugfixes and improvements from PT2.2A to PT2.3A:
  307. ------------------------------------------------
  308. -Mountlist in PLST is fixed. Before it asked for disks in all drives even if
  309.  you didn't have extradrives.
  310.  
  311. -Helpfile fixed. In the betaversion the jumptable was corrupt.
  312.  
  313. -Pointer color was green after succesful saving. This one is fixed now.
  314.  
  315. -In the betaversion you couldn't exit POS-ed with ESC.
  316.  
  317. -PT shouldn't quit with ESC. This is fixed now. Use Alt+Q (This one has been
  318.  there all the time) or click in the top-left corner to quit.
  319.  
  320. -There was a bug in the Entry jump routine (Shift+Desired character) in
  321.  Disk.op, PLST and PresetED. If you had directories in the current path
  322.  PT jumped to the first DIRECTORY starting with the desired character instead
  323.  of searching for the first FILE beginning with that character.
  324.  
  325. -Some minor bugs fixed as well.
  326.  
  327.  
  328.  
  329. Known bugs, errors, stupid things and other crap:
  330. -------------------------------------------------
  331.  
  332. - If you load a song or module that's not a proper ST-module,
  333.   Protracker may trash the upper left of the screen and/or crash.
  334.   This screen-trashing may also happen other times. Don't ask us why
  335.   or when. There is really no proper way to check if a file is a module
  336.   or song. We check for "M.K." at offset 1080, and if isn't found,
  337.   Protracker asks if you want to load it with 31 samples, since it may
  338.   be a Startrekker module. If you answer no, PT assumes it's an old
  339.   15 samples song/module.
  340.  
  341. - If you format a disk with Protracker, it's possible to save files to the
  342.   disk, but if you try to load the files you just saved, nothing comes up
  343.   in the disk op. screen.  If could be that the Amiga has some problems
  344.   validating the disk, but there are no such messages. We'll have a look
  345.   at the Format routine.If you get any problems, try to take out the disk
  346.   and insert it again.PT should now re-read the dir.
  347.  
  348. - You cannot have two presets with the same name on different ST-disks.
  349.  
  350. - I have noticed that powerpacker.library crunches some samples/modules
  351.   improperly. (This goes with the powerpacker program as well).
  352.   Be sure to check the packed files before you delete the sourcefiles!
  353.  
  354.  
  355.